Función DsGetRdnW (dsparse.h)

La función DsGetRdnW recupera la clave y el valor del primer nombre distintivo relativo y un puntero al siguiente nombre distintivo relativo de una cadena de nombre distintivo distintivo.

Sintaxis

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

Parámetros

[in, out] ppDN

Dirección de un puntero de cadena Unicode que, en la entrada, contiene la cadena de nombre distintivo que se va a analizar. La longitud de esta cadena se especifica en el parámetro pcDN . Si la función se ejecuta correctamente, este parámetro se ajusta para que apunte al resto del nombre distintivo exclusivo del nombre distintivo actual. Por ejemplo, si este parámetro apunta a la cadena "dc=corp,dc=fabrikam,dc=com", una vez completada la función, este parámetro apunta a la cadena ",dc=fabrikam,dc=com".

[in, out] pcDN

Puntero a un valor DWORD que, en la entrada, contiene el número de caracteres de la cadena ppDN . Si la función se ejecuta correctamente, este parámetro recibe el número de caracteres en el resto del nombre distintivo. Estos valores no incluyen el carácter terminado en null.

[out] ppKey

Puntero a un valor LPCWCH que, si la función se ejecuta correctamente, recibe un puntero a la clave de la cadena de nombre distintivo relativa. Este puntero está dentro de la cadena ppDN y no termina en null. El parámetro pcKey recibe el número de caracteres de la clave. Este parámetro no está definido si pcKey recibe cero.

[out] pcKey

Puntero a un valor DWORD que, si la función se ejecuta correctamente, recibe el número de caracteres de la cadena de clave representada por el parámetro ppKey . Si este parámetro recibe cero, ppKey no está definido.

[out] ppVal

Puntero a un valor LPCWCH que, si la función es correcta, recibe un puntero al valor de la cadena de nombre distintivo relativa. Este puntero está dentro de la cadena ppDN y no termina en null. El parámetro pcVal recibe el número de caracteres del valor. Este parámetro no está definido si pcVal recibe cero.

[out] pcVal

Puntero a un valor DWORD que, si la función se ejecuta correctamente, recibe el número de caracteres de la cadena de valor representada por el parámetro ppVal . Si este parámetro recibe cero, ppVal no está definido.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o si un código de error win32 de lo contrario. Los códigos de error posibles incluyen los siguientes valores.

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsparse.h (incluya Ntdsapi.h)
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll

Consulte también

Funciones de administración de controlador de dominio y replicación