KsUnserializeObjectPropertiesFromRegistry, fonction (ks.h)

La fonction KsUnserializeObjectPropertiesFromRegistry , lorsqu’elle reçoit un objet de destination et un chemin d’accès au Registre, énumère les valeurs nommées et les applique en tant que données sérialisées aux jeux de propriétés spécifiés répertoriés dans les données sérialisées. Un IRP étant généré lors de l’envoi des données sérialisées, aucune hypothèse n’est faite sur l’utilisation des structures de propriété KS pour définir en interne les jeux de propriétés. La fonction n’utilise pas les noms des valeurs.

Syntaxe

KSDDKAPI NTSTATUS KsUnserializeObjectPropertiesFromRegistry(
  [in]           PFILE_OBJECT    FileObject,
  [in, optional] HANDLE          ParentKey,
  [in, optional] PUNICODE_STRING RegistryPath
);

Paramètres

[in] FileObject

Spécifie l’objet file dont les propriétés sont définies.

[in, optional] ParentKey

Contient éventuellement un handle pour le parent du chemin d’accès, ou NULL. La clé parente et/ou le RegistryPath doivent être passés.

[in, optional] RegistryPath

Contient éventuellement le chemin d’accès à la clé dont les sous-clés seront énumérées en tant que jeux de propriétés, ou null. La parentkey et/ou le chemin d’accès du Registre doivent être passés.

Valeur retournée

La fonction KsUnserializeObjectPropertiesFromRegistry retourne STATUS_SUCCESS si les jeux de propriétés n’étaient pasialisés. La fonction retourne une erreur si le chemin du Registre n’était pas valide, si l’une des sous-clés n’était pas valide, si la définition d’une propriété a échoué, si le format sérialisé n’était pas valide ou si un jeu de propriétés n’était pas pris en charge sur l’objet .

Configuration requise