URLAssociationDialogA-Funktion (intshcut.h)
Ruft das Nicht registrierte URL-Protokolldialogfeld auf. In diesem Dialogfeld kann der Benutzer eine Anwendung auswählen, die einem zuvor unbekannten Protokoll zugeordnet werden soll.
Syntax
INTSHCUTAPI HRESULT URLAssociationDialogA(
HWND hwndParent,
DWORD dwInFlags,
PCSTR pcszFile,
PCSTR pcszURL,
[out] PSTR pszAppBuf,
UINT ucAppBufLen
);
Parameter
hwndParent
Typ: HWND
Ein Handle für das übergeordnete Fenster.
dwInFlags
Art: DWORD
Die Bitflags, die das Verhalten der Funktion angeben. Dieser Wert kann eine Kombination aus folgendem Wert sein:
URLASSOCDLG_FL_USE_DEFAULT_NAME
Verwenden Sie den Standarddateinamen (also "Internetverknüpfung").
URLASSOCDLG_FL_REGISTER_ASSOC
Registrieren Sie die ausgewählte Anwendung als Handler für das in pcszURL angegebene Protokoll. Die Anwendung wird nur registriert, wenn dieses Flag festgelegt ist und der Benutzer angibt, dass eine persistente Zuordnung gewünscht wird.
pcszFile
Typ: PTCSTR
Die Adresse einer konstanten Zeichenfolge mit 0-Endung, die den Dateinamen enthält, der dem URLs-Protokoll zugeordnet werden soll.
pcszURL
Typ: PTCSTR
Die Adresse einer konstanten Zeichenfolge, die die URL mit einem unbekannten Protokoll enthält.
[out] pszAppBuf
Typ: PTSTR
Die Adresse eines Puffers, der den vom Benutzer angegebenen Pfad der Anwendung empfängt.
ucAppBufLen
Typ: UINT
Die Größe von pszAppBuf in Zeichen.
Rückgabewert
Typ: HRESULT
Hinweise
Hinweis
Der Intshcut.h-Header definiert URLAssociationDialog als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | intshcut.h |
DLL | Url.dll |