URLAssociationDialogW-Funktion (intshcut.h)

Artikel
08/24/2023

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.

Hinweis Windows XP Service Pack 2 (SP2) oder höher: Diese Funktion wird nicht mehr unterstützt.

Syntax

INTSHCUTAPI HRESULT URLAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszURL,
  [out] PWSTR  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

Hinweis Ab Windows XP SP2 wird diese Funktion nicht unterstützt und gibt in allen Situationen E_NOTIMPL zurück.

Gibt in unterstützten Systemen S_OK zurück, wenn die Anwendung mit dem URL-Protokoll registriert ist, oder S_FALSE, wenn nichts registriert ist. Beispielsweise gibt die Funktion S_FALSE zurück, wenn der Benutzer eine einmalige Ausführung über die ausgewählte Anwendung durchführt.

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


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

Share via