Função DsGetRdnW (dsparse.h)

Artigo
03/14/2023

A função DsGetRdnW recupera a chave e o valor do primeiro nome distinto relativo e um ponteiro para o próximo nome distinto relativo de uma cadeia de caracteres de nome diferenciada.

Sintaxe

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

Endereço de um ponteiro de cadeia de caracteres Unicode que, na entrada, contém a cadeia de caracteres de nome diferenciada a ser analisada. O comprimento dessa cadeia de caracteres é especificado no parâmetro pcDN . Se a função for bem-sucedida, esse parâmetro será ajustado para apontar para o restante do nome diferenciado exclusivo do nome distinto relativo atual. Por exemplo, se esse parâmetro apontar para a cadeia de caracteres "dc=corp,dc=fabrikam,dc=com", depois que a função for concluída, esse parâmetro apontará para a cadeia de caracteres "dc=fabrikam,dc=com".

[in, out] pcDN

Ponteiro para um valor DWORD que, na entrada, contém o número de caracteres na cadeia de caracteres ppDN . Se a função for bem-sucedida, esse parâmetro receberá o número de caracteres no restante do nome diferenciado. Esses valores não incluem o caractere terminado em nulo.

[out] ppKey

Ponteiro para um valor LPCWCH que, se a função for bem-sucedida, receberá um ponteiro para a chave na cadeia de caracteres de nome diferenciada relativa. Esse ponteiro está dentro da cadeia de caracteres ppDN e não é encerrado em nulo. O parâmetro pcKey recebe o número de caracteres na chave. Esse parâmetro será indefinido se pcKey receber zero.

[out] pcKey

Ponteiro para um valor DWORD que, se a função for bem-sucedida, receberá o número de caracteres na cadeia de caracteres de chave representada pelo parâmetro ppKey . Se esse parâmetro receber zero, ppKey será indefinido.

[out] ppVal

Ponteiro para um valor LPCWCH que, se a função for bem-sucedida, receberá um ponteiro para o valor na cadeia de caracteres de nome distinto relativa. Esse ponteiro está dentro da cadeia de caracteres ppDN e não é encerrado em nulo. O parâmetro pcVal recebe o número de caracteres no valor . Esse parâmetro será indefinido se pcVal receber zero.

[out] pcVal

Ponteiro para um valor DWORD que, se a função for bem-sucedida, receberá o número de caracteres na cadeia de caracteres de valor representada pelo parâmetro ppVal . Se esse parâmetro receber zero, ppVal será indefinido.

Valor retornado

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro Win32 caso contrário. Os códigos de erro possíveis incluem os valores a seguir.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	dsparse.h (inclua Ntdsapi.h)
Biblioteca	Ntdsapi.lib
DLL	Ntdsapi.dll

Confira também

Funções de gerenciamento de replicação e controlador de domínio

Compartilhar via