URLAssociationDialogA-Funktion (intshcut.h)

Artikel
11/20/2024

Ruft das Dialogfeld "Nicht registriertes URL-Protokoll" 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 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

Typ: DWORD-

Die Bitkennzeichnungen, die das Verhalten der Funktion angeben. Dieser Wert kann eine Kombination aus folgendem Sein:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Verwenden Sie den Standarddateinamen (d. a. "Internetverknüpfung").

URLASSOCDLG_FL_REGISTER_ASSOC

Registrieren Sie die ausgewählte Anwendung als Handler für das in pcszURLangegebene Protokoll. Die Anwendung wird nur registriert, wenn dieses Flag festgelegt ist und der Benutzer angibt, dass eine dauerhafte Zuordnung gewünscht wird.

pcszFile

Typ: PTCSTR-

Die Adresse einer konstanten Zeichenfolge mit Nullen, die den Dateinamen enthält, der dem URLs-Protokoll zugeordnet werden soll.

pcszURL

Typ: PTCSTR-

Die Adresse einer konstanten Null-beendeten Zeichenfolge, die die URL mit einem unbekannten Protokoll enthält.

[out] pszAppBuf

Typ: PTSTR-

Die Adresse eines Puffers, der den Pfad der vom Benutzer angegebenen Anwendung empfängt.

ucAppBufLen

Typ: UINT-

Die Größe von pszAppBufin 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. Die Funktion gibt z. B. S_FALSE zurück, wenn der Benutzer eine einmalige Ausführung über die ausgewählte Anwendung durchführt.

Bemerkungen

Anmerkung

Der Header intshcut.h 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	intshcut.h
DLL-	Url.dll

Freigeben über