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.

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