Função KsUnserializeObjectPropertiesFromRegistry (ks.h)

A função KsUnserializeObjectPropertiesFromRegistry, quando dado um objeto de destino e um caminho do Registro, enumera os valores nomeados e os aplica como dados serializados aos conjuntos de propriedades especificados listados nos dados serializados. Um IRP é gerado ao enviar os dados serializados, portanto, nenhuma suposição é feita sobre o uso de estruturas de propriedade KS para definir internamente os conjuntos de propriedades. A função não usa os nomes dos valores.

Sintaxe

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

Parâmetros

[in] FileObject

Especifica o objeto de arquivo cujas propriedades estão sendo definidas.

[in, optional] ParentKey

Opcionalmente, contém um identificador para o pai do caminho ou NULL. A chave pai e/ou a registryPath devem ser passadas.

[in, optional] RegistryPath

Opcionalmente, contém o caminho para a chave cujas subchaves serão enumeradas como conjuntos de propriedades ou NULL. O ParentKey e/ou o Caminho do Registro deve ser passado.

Valor de retorno

A função KsUnserializeObjectPropertiesFromRegistry retornará STATUS_SUCCESS se os conjuntos de propriedades não foram sequenciados. A função retornará um erro se o caminho do Registro for inválido, uma das subchaves for inválida, a definição de uma propriedade não tiver sido bem-sucedida, o formato serializado for inválido ou um conjunto de propriedades não tiver suporte no objeto.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib