estrutura DS_NAME_RESULT_ITEMW (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 ...
  WCHAR  *pDomain;
#if ...
  WCHAR  *pName;
#else
  LPWSTR pDomain;
#endif
#else
  LPWSTR pName;
#endif
} DS_NAME_RESULT_ITEMW, *PDS_NAME_RESULT_ITEMW;

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.

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 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