Condividi tramite


Funzione WdfRegistryAssignUnicodeString (wdfregistry.h)

[Si applica a KMDF e UMDF]

Il metodo WdfRegistryAssignUnicodeString assegna una stringa Unicode specificata a un nome di valore specificato nel Registro di sistema.

Sintassi

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

Parametri

[in] Key

Handle per un oggetto chiave del Registro di sistema che rappresenta una chiave del Registro di sistema aperta.

[in] ValueName

Puntatore a una struttura UNICODE_STRING che contiene un nome di valore.

[in] Value

Puntatore a una struttura UNICODE_STRING che contiene la stringa da assegnare al nome di valore specificato da ValueName .

Valore restituito

WdfRegistryAssignUnicodeString restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire uno dei valori seguenti:

Codice restituito Descrizione
STATUS_INVALID_DEVICE_REQUEST

WdfRegistryAssignUnicodeString non è stato chiamato in IRQL = PASSIVE_LEVEL.

STATUS_INVALID_PARAMETER
È stato specificato un parametro non valido.
STATUS_ACCESS_DENIED
Il driver non ha aperto la chiave del Registro di sistema con accesso KEY_SET_VALUE.
STATUS_INSUFFICIENT_RESOURCES
Memoria insufficiente per completare l'operazione.
 

Questo metodo potrebbe anche restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Se la stringa specificata dal parametro Value non è con terminazione NULL, il framework aggiunge un carattere NULL durante la copia della stringa nel Registro di sistema.

Se il nome del valore specificato dal parametro ValueName esiste già, WdfRegistryAssignUnicodeString aggiorna i dati del valore.

Il framework imposta il tipo di dati del valore su REG_SZ.

Per altre informazioni sugli oggetti chiave del Registro di sistema, vedere Uso del Registro di sistema nei driver Framework-Based.

Esempio

Nell'esempio di codice seguente viene assegnata una stringa Unicode "String1" al valore ValueName , in una chiave del Registro di sistema specificata.

UNICODE_STRING ustring1, valueName;
NTSTATUS status;

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

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

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfregistry.h (include Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

RtlInitUnicodeString

UNICODE_STRING

WdfRegistryAssignMemory

WdfRegistryAssignMultiString

WdfRegistryAssignString

WdfRegistryAssignULong

WdfRegistryAssignValue