Funzione DsGetRdnW (dsparse.h)

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

Vedi anche

Funzioni di gestione del controller di dominio e della replica