MIMEAssociationDialogW-Funktion (intshcut.h)

Artikel
08/24/2023

Führt das Dialogfeld für den nicht registrierten MIME-Inhaltstyp aus.

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

Syntax

INTSHCUTAPI HRESULT MIMEAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszMIMEContentType,
  [out] PWSTR  pszAppBuf,
        UINT   ucAppBufLen
);

Parameter

hwndParent

Typ: HWND

Ein Handle für das übergeordnete Fenster aller bereitgestellten untergeordneten Fenster.

dwInFlags

Art: DWORD

Ein Bitflagwert, der angibt, ob eine Zuordnung registriert werden soll. Das Bitflag ist der Wert MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Wenn dieses Bit festgelegt ist, wird die ausgewählte Anwendung als Handler für den angegebenen MIME-Typ registriert. Wenn dieses Bit eindeutig ist, wird keine Zuordnung registriert.

Eine Anwendung wird nur registriert, wenn dieses Flag festgelegt ist und der Benutzer angibt, dass eine dauerhafte Zuordnung vorgenommen werden soll.

Die Registrierung ist nicht möglich, wenn die Zeichenfolge bei pcszFile keine Erweiterung enthält.

pcszFile

Typ: PCTSTR

Die Adresse einer Zeichenfolge mit NULL-Beendigung, die den Namen der Zieldatei enthält. Diese Datei muss dem Inhaltstyp entsprechen, der durch den parameter pcszMIMEContentType beschrieben wird.

pcszMIMEContentType

Typ: PCTSTR

Die Adresse einer Zeichenfolge mit NULL-Beendigung, die den nicht registrierten Inhaltstyp enthält.

[out] pszAppBuf

Typ: PTSTR

Ein Zeiger auf einen Puffer, der nach erfolgreicher Rückgabe dieser Funktion den Pfad der vom Benutzer angegebenen Anwendung empfängt.

ucAppBufLen

Typ: UINT

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 der Inhaltstyp erfolgreich der Erweiterung zugeordnet wurde. In diesem Fall wird die Erweiterung als Standard für den Inhaltstyp zugeordnet, und pszAppBuf verweist auf die Zeichenfolge, die den Pfad der angegebenen Anwendung enthält. Die Funktion gibt S_FALSE zurück, wenn nichts registriert wurde. Andernfalls lautet der Rückgabewert einer der folgenden:

Rückgabecode	Beschreibung
E_ABORT	Der Benutzer hat den Vorgang abgebrochen.
E_FLAGS	Die in dwInFlags übergebene Flagkombination ist ungültig.
E_OUTOFMEMORY	Es war nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
E_POINTER	Einer der Eingabezeiger ist ungültig.

Hinweise

Diese Funktion überprüft nicht die Syntax der Eingabeinhaltstypzeichenfolge bei pcszMIMEContentType. Ein erfolgreicher Rückgabewert gibt nicht an, dass der angegebene MIME-Inhaltstyp gültig ist.

Hinweis

Der Header intshcut.h definiert MIMEAssociationDialog 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