Funzione DsGetRdnW (dsparse.h)

Articolo
03/14/2023

La funzione DsGetRdnW recupera la chiave e il valore del primo nome distinto relativo e un puntatore al nome distinto relativo successivo da una stringa di nome distinto distinto.

Sintassi

DSPARSE DWORD DsGetRdnW(
  [in, out] LPCWCH *ppDN,
  [in, out] DWORD  *pcDN,
  [out]     LPCWCH *ppKey,
  [out]     DWORD  *pcKey,
  [out]     LPCWCH *ppVal,
  [out]     DWORD  *pcVal
);

Parametri

[in, out] ppDN

Indirizzo di un puntatore stringa Unicode che, nella voce, contiene la stringa di nome distinto da analizzare. La lunghezza di questa stringa viene specificata nel parametro pcDN . Se la funzione ha esito positivo, questo parametro viene modificato per puntare al resto del nome distinto esclusivo del nome distinto corrente. Ad esempio, se questo parametro punta alla stringa "dc=corp,dc=fabrikam,dc=com", dopo che la funzione è stata completata, questo parametro punta alla stringa ",dc=fabrikam,dc=com".

[in, out] pcDN

Puntatore a un valore DWORD che, nella voce, contiene il numero di caratteri nella stringa ppDN . Se la funzione ha esito positivo, questo parametro riceve il numero di caratteri nel resto del nome distinto. Questi valori non includono il carattere con terminazione Null.

[out] ppKey

Puntatore a un valore LPCWCH che, se la funzione ha esito positivo, riceve un puntatore alla chiave nella stringa di nome distinto relativa. Questo puntatore si trova all'interno della stringa ppDN e non viene terminato null. Il parametro pcKey riceve il numero di caratteri nella chiave. Questo parametro non è definito se pcKey riceve zero.

[out] pcKey

Puntatore a un valore DWORD che, se la funzione ha esito positivo, riceve il numero di caratteri nella stringa chiave rappresentata dal parametro ppKey . Se questo parametro riceve zero, ppKey non è definito.

[out] ppVal

Puntatore a un valore LPCWCH che, se la funzione ha esito positivo, riceve un puntatore al valore nella stringa del nome distinto relativo. Questo puntatore si trova all'interno della stringa ppDN e non viene terminato null. Il parametro pcVal riceve il numero di caratteri nel valore. Questo parametro non è definito se pcVal riceve zero.

[out] pcVal

Puntatore a un valore DWORD che, se la funzione ha esito positivo, riceve il numero di caratteri nella stringa di valore rappresentata dal parametro ppVal . Se questo parametro riceve zero, ppVal non è definito.

Valore restituito

Restituisce ERROR_SUCCESS se ha esito positivo o un codice di errore Win32 in caso contrario. I codici di errore possibili includono i valori seguenti.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsparse.h (include Ntdsapi.h)
Libreria	Ntdsapi.lib
DLL	Ntdsapi.dll

Vedi anche

Funzioni di gestione del controller di dominio e della replica

Condividi tramite