Compartilhar via


estrutura DS_NAME_RESULT_ITEMA (ntdsapi.h)

A estrutura DS_NAME_RESULT_ITEM contém um nome convertido pela função DsCrackNames , juntamente com dados de erro e domínio associados.

Sintaxe

typedef struct {
  DWORD status;
#if ...
  CHAR  *pDomain;
#if ...
  CHAR  *pName;
#else
  LPSTR pDomain;
#endif
#else
  LPSTR pName;
#endif
} DS_NAME_RESULT_ITEMA, *PDS_NAME_RESULT_ITEMA;

Membros

status

Contém um dos valores de DS_NAME_ERROR que indica o status dessa conversão de nome.

pDomain

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o domínio DNS no qual o objeto reside. Esse membro conterá dados válidos se status contiver DS_NAME_NO_ERROR ou DS_NAME_ERROR_DOMAIN_ONLY.

pName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do objeto recém-formatado.

Comentários

A função DsCrackNames retorna uma matriz de estruturas DS_NAME_RESULT_ITEM como parte da estrutura DS_NAME_RESULT .

Observação

O cabeçalho ntdsapi.h define DS_NAME_RESULT_ITEM como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Cabeçalho ntdsapi.h

Confira também

DS_NAME_RESULT

Estruturas de gerenciamento de replicação e controlador de domínio

DsCrackNames