Funzione URLAssociationDialogA (intshcut.h)

Articolo
02/29/2024

Richiama la finestra di dialogo Protocollo URL non registrato. Questa finestra di dialogo consente all'utente di selezionare un'applicazione da associare a un protocollo precedentemente sconosciuto.

Nota Windows XP Service Pack 2 (SP2) o versione successiva: questa funzione non è più supportata.

Sintassi

INTSHCUTAPI HRESULT URLAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszURL,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Parametri

hwndParent

Tipo: HWND

Handle per la finestra padre.

dwInFlags

Tipo: DWORD

Flag di bit che specificano il comportamento della funzione. Questo valore può essere una combinazione dei seguenti elementi:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Usare il nome file predefinito , ovvero "Collegamento a Internet".

URLASSOCDLG_FL_REGISTER_ASSOC

Registrare l'applicazione selezionata come gestore per il protocollo specificato in pcszURL. L'applicazione viene registrata solo se questo flag è impostato e l'utente indica che è desiderata un'associazione persistente.

pcszFile

Tipo: DIGITSTR

Indirizzo di una stringa costante con terminazione zero contenente il nome del file da associare al protocollo URL.

pcszURL

Tipo: DIGITSTR

Indirizzo di una stringa costante con terminazione zero contenente l'URL con un protocollo sconosciuto.

[out] pszAppBuf

Tipo: PTSTR

Indirizzo di un buffer che riceve il percorso dell'applicazione specificata dall'utente.

ucAppBufLen

Tipo: UINT

Dimensioni di pszAppBuf, in caratteri.

Valore restituito

Tipo: HRESULT

Nota A partire da Windows XP SP2, questa funzione non è supportata e restituisce E_NOTIMPL in tutte le situazioni.

Nei sistemi supportati restituisce S_OK se l'applicazione è registrata con il protocollo URL o S_FALSE se non viene registrato alcun elemento. Ad esempio, la funzione restituisce S_FALSE quando l'utente sceglie di eseguire un'esecuzione una tantum tramite l'applicazione selezionata.

Commenti

Nota

L'intestazione intshcut.h definisce URLAssociationDialog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	intshcut.h
DLL	Url.dll

Condividi tramite