Freigeben über


CryptSIPRetrieveSubjectGuidForCatalogFile-Funktion (mssip.h)

Die Funktion CryptSIPRetrieveSubjectGuidForCatalogFile ruft die der angegebenen Datei zugeordnete Betreff-GUID ab.

Syntax

BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
  [in]           LPCWSTR FileName,
  [in, optional] HANDLE  hFileIn,
  [out]          GUID    *pgSubject
);

Parameter

[in] FileName

Der Name der Datei. Wenn der hFileIn-Parameter festgelegt ist, wird der Wert in diesem Parameter ignoriert.

[in, optional] hFileIn

Ein Handle für die zu überprüfende Datei. Dieser Parameter muss ein gültiges Handle enthalten, wenn der FileName-ParameterNULL ist.

[out] pgSubject

Eine global eindeutige ID, die den Antragsteller identifiziert.

Rückgabewert

Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. andernfalls FALSE.

Wenn diese Funktion FALSE zurückgibt, können zusätzliche Fehlerinformationen abgerufen werden, indem die GetLastError-Funktion aufgerufen wird. GetLastError gibt einen der folgenden Fehlercodes zurück.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
Mindestens ein Parameter ist ungültig.

Hinweise

Diese Funktion unterstützt nur Subject Interface Packages (SIPs), die für portable ausführbare Images (.exe), Cabinet-Images (.cab) und Flatfiles verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mssip.h
Bibliothek Crypt32.lib
DLL Crypt32.dll