Fonction CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)

Article
02/29/2024

La fonction CryptSIPRetrieveSubjectGuidForCatalogFile récupère le GUID d’objet associé au fichier spécifié.

Syntaxe

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

Paramètres

[in] FileName

Nom du fichier. Si le paramètre hFileIn est défini, la valeur de ce paramètre est ignorée.

[in, optional] hFileIn

Handle du fichier à case activée. Ce paramètre doit contenir un handle valide si le paramètre FileName a la valeur NULL.

[out] pgSubject

ID global unique qui identifie l’objet.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit ; sinon, FALSE.

Si cette fonction retourne FALSE, des informations d’erreur supplémentaires peuvent être obtenues en appelant la fonction GetLastError . GetLastError retourne l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.

Remarques

Cette fonction prend uniquement en charge les packages d’interface d’objet (SIP) utilisés pour les images exécutables portables (.exe), les images d’armoire (.cab) et les fichiers plats.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mssip.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Partager via