Compartilhar via


DS_NAME_RESULT_ITEMA estrutura (ntdsapi.h)

A estrutura DS_NAME_RESULT_ITEM contém um nome convertido pela função DsCrackNames, juntamente com dados de domínio e erros 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 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 formatado recentemente.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista
servidor com suporte mínimo Windows Server 2008
cabeçalho ntdsapi.h

Consulte também

DS_NAME_RESULT

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

DsCrackNames