MIMEAssociationDialogA-Funktion (intshcut.h)
Führt das Dialogfeld "Nicht registrierter MIME-Inhaltstyp" aus.
Syntax
INTSHCUTAPI HRESULT MIMEAssociationDialogA(
HWND hwndParent,
DWORD dwInFlags,
PCSTR pcszFile,
PCSTR pcszMIMEContentType,
[out] PSTR pszAppBuf,
UINT ucAppBufLen
);
Parameter
hwndParent
Typ: HWND
Ein Handle zum übergeordneten 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 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 nicht möglich, wenn die Zeichenfolge bei pcszFile keine Erweiterung enthält.
pcszFile
Typ: PCTSTR
Die Adresse einer NULL-beendeten Zeichenfolge, 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 NULL-beendeten Zeichenfolge, die den nicht registrierten Inhaltstyp enthält.
[out] pszAppBuf
Typ: PTSTR
Ein Zeiger auf einen Puffer, der bei 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
Rückgabecode | Beschreibung |
---|---|
|
Der Benutzer hat den Vorgang abgebrochen. |
|
Die in dwInFlags übergebene Flagkombination ist ungültig. |
|
Es war nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
|
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 nicht codierungsneutralem Code 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 |