pfnIsFileSupportedName-Rückruffunktion (mssip.h)

Die Rückruffunktion pfnIsFileSupportedName fragt die in der Registrierung aufgeführten Subject Interface Packages (SIPs) ab, um zu bestimmen, welches SIP den Dateityp verarbeitet.

Syntax

pfnIsFileSupportedName Pfnisfilesupportedname;

BOOL Pfnisfilesupportedname(
  [in]  WCHAR *pwszFileName,
  [out] GUID *pgSubject
)
{...}

Parameter

[in] pwszFileName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den absoluten Pfad zu der Datei enthält, die vom SIP verarbeitet werden soll.

[out] pgSubject

Die GUID, die das SIP identifiziert, das den Dateityp verarbeitet.

Rückgabewert

Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. FALSE , wenn die Funktion fehlschlägt. Wenn die Funktion fehlschlägt, rufen Sie die GetLastError-Funktion auf, um die Ursache für den Fehler zu ermitteln.

Hinweise

Wenn der SIP den von hfile übergebenen Dateityp unterstützt, gibt die Funktion TRUE zurück und legt pgSubject auf die GUID fest, die den SIP für die Verarbeitung des Dateityps identifiziert.

Jedes SIP implementiert eine eigene Version der Funktion, die bestimmt, ob der Dateityp unterstützt wird. Der spezifische Name der Funktion kann je nach Implementierung des SIP variieren, aber die Signatur der Funktion stimmt mit der der SIP_ADD_NEWPROVIDER-Struktur überein.

SIPs müssen einen begrenzten Satz von Dateitypen und Dateierweiterungen unterstützen. Die fileSupportedName-Funktion muss überprüfen, ob die bereitgestellte Datei mit einer der vom SIP unterstützten Dateierweiterungen übereinstimmt. Für instance unterstützt der WSH-SIP nur die folgende Liste von Dateierweiterungen und überprüft, ob die zu überprüfene Datei Mitglied der folgenden Liste ist: .js, JSE, VBE, VBS oder WSF.

Anforderungen

Weitere Informationen

pfnIsFileSupported