CryptSIPRetrieveSubjectGuidForCatalogFile-Funktion (mssip.h)

Artikel
03/06/2024

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

Freigeben über