Funzione CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)

La funzione CryptSIPRetrieveSubjectGuidForCatalogFile recupera il GUID soggetto associato al file specificato.

Sintassi

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

Parametri

[in] FileName

Nome del file. Se il parametro hFileIn è impostato, il valore in questo parametro viene ignorato.

[in, optional] hFileIn

Handle per il file da controllare. Questo parametro deve contenere un handle valido se il parametro FileName è NULL.

[out] pgSubject

ID univoco globale che identifica l'oggetto.

Valore restituito

Il valore restituito è TRUE se la funzione ha esito positivo; in caso contrario, FALSE.

Se questa funzione restituisce FALSE, è possibile ottenere informazioni aggiuntive sull'errore chiamando la funzione GetLastError . GetLastError restituirà uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.

Commenti

Questa funzione supporta solo i pacchetti di interfaccia soggetto (SIP) usati per immagini eseguibili portabili (.exe), immagini cab (.cab) e file flat.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mssip.h
Libreria	Crypt32.lib
DLL	Crypt32.dll