Funzione URLAssociationDialogA (intshcut.h)
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.
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
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 |