MIMEAssociationDialogA-Funktion (intshcut.h)

Artikel
11/20/2024

Führt das Dialogfeld für 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 MIMEAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszMIMEContentType,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Parameter

hwndParent

Typ: HWND-

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

dwInFlags

Typ: DWORD-

Ein Bitkennzeichnungswert, der angibt, ob eine Zuordnung registriert werden soll. Das Bit-Flag 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 klar 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 unmöglich, wenn die Zeichenfolge bei pcszFile keine Erweiterung enthält.

pcszFile

Typ: PCTSTR-

Die Adresse einer mit Null beendeten Zeichenfolge, die den Namen der Zieldatei enthält. Diese Datei muss dem vom pcszMIMEContentType Parameter beschriebenen Inhaltstyp entsprechen.

pcszMIMEContentType

Typ: PCTSTR-

Die Adresse einer mit Null beendeten Zeichenfolge, die den nicht registrierten Inhaltstyp enthält.

[out] pszAppBuf

Typ: PTSTR-

Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgegeben wird, den Pfad der vom Benutzer angegebenen Anwendung empfängt.

ucAppBufLen

Typ: UINT-

Größe 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 der Inhaltstyp der Erweiterung erfolgreich 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 ist der Rückgabewert einer der folgenden:

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

Bemerkungen

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.

Anmerkung

Der Header intshcut.h definiert MIMEAssociationDialog als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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