Funzione URLAssociationDialogA (intshcut.h)

Articolo
11/20/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 sconosciuto in precedenza.

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 di quanto segue:

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 permanente.

pcszFile

Tipo:

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

pcszURL

Tipo:

Indirizzo di una stringa con terminazione zero costante che contiene 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	intshcut.h
dll	Url.dll

Condividi tramite