Función WdfRegistryAssignUnicodeString (wdfregistry.h)

[Se aplica a KMDF y UMDF]

El método WdfRegistryAssignUnicodeString asigna una cadena Unicode especificada a un nombre de valor especificado en el Registro.

Sintaxis

NTSTATUS WdfRegistryAssignUnicodeString(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] PCUNICODE_STRING Value
);

Parámetros

[in] Key

Identificador de un objeto de clave del Registro que representa una clave del Registro abierta.

[in] ValueName

Puntero a una estructura UNICODE_STRING que contiene un nombre de valor.

[in] Value

Puntero a una estructura de UNICODE_STRING que contiene la cadena que se va a asignar al nombre de valor que ValueName especifica.

Valor devuelto

WdfRegistryAssignUnicodeString devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, el método podría devolver uno de los siguientes valores:

Este método también puede devolver otros valores de NTSTATUS.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Observaciones

Si la cadena que especifica el valor parámetro no está terminada en NULL, el marco agrega un carácter NULL al copiar la cadena en el registro.

Si el nombre del valor que el parámetro ValueName especifica ya existe, WdfRegistryAssignUnicodeString actualiza los datos del valor.

El marco establece el tipo de datos del valor en REG_SZ.

Para obtener más información sobre los objetos de clave del Registro, vea Using the Registry in Framework-Based Drivers.

Ejemplos

En el ejemplo de código siguiente se asigna una cadena Unicode "String1" al valor de ValueName, en una clave del Registro especificada.

UNICODE_STRING ustring1, valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &ustring1,
                     L"String1"
                     );
RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );

status = WdfRegistryAssignUnicodeString(
                                        Key,
                                        &valueName,
                                        &string1
                                        );

Requisitos

Consulte también

RtlInitUnicodeString

UNICODE_STRING

WdfRegistryAssignMemory

WdfRegistryAssignMultiString

WdfRegistryAssignString

WdfRegistryAssignULong

WdfRegistryAssignValue