Função DsCrackUnquotedMangledRdnA (dsparse.h)

Artigo
11/20/2024

A função DsCrackUnquotedMangledRdn desembaraça (decodifica) um determinado nome distinto relativo e retorna o GUID decodificado e o tipo de mangling usado.

Sintaxe

DSPARSE BOOL DsCrackUnquotedMangledRdnA(
  [in]            LPCSTR        pszRDN,
  [in]            DWORD         cchRDN,
  [out, optional] GUID          *pGuid,
  [out, optional] DS_MANGLE_FOR *peDsMangleFor
);

Parâmetros

[in] pszRDN

Ponteiro para uma cadeia de caracteres que contém o RDN (nome diferenciado relativo) a ser convertido. Esse comprimento de cadeia de caracteres é especificado pelo parâmetro cchRDN, portanto, essa cadeia de caracteres não precisa ser terminada em nulo. Essa cadeia de caracteres deve estar em forma não cotada. Para obter mais informações sobre nomes distintos relativos não citados, consulte DsUnquoteRdnValue.

[in] cchRDN

Contém o comprimento, em caracteres, da cadeia de caracteres pszRDN.

[out, optional] pGuid

Ponteiro para GUID valor que recebe o GUID do nome distinto relativo não mutilado. Esse parâmetro pode ser NULL.

[out, optional] peDsMangleFor

Ponteiro para um valor DS_MANGLE_FOR que recebe o tipo de mangling usado no nome diferenciado relativo mutilado. Esse parâmetro pode ser NULL.

Valor de retorno

Essa função retornará VERDADEIRO se o nome diferenciado relativo estiver mutilado ou FALSE caso contrário. Se essa função retornar FALSE, nem pGuid nem peDsMangleFor receber dados.

Observações

Essa função tenta decodificar (desmanar) um RDN que foi anteriormente mutilado devido a uma exclusão ou um conflito de nomenclatura. Se o nome diferenciado relativo for mutilado, a função retornará VERDADEIRO e recuperará o tipo GUID e de mutilação, se solicitado. Se o nome diferenciado relativo não estiver mutilado, a função retornará false.

Nota

O cabeçalho dsparse.h define DsCrackUnquotedMangledRdn 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
da Plataforma de Destino	Windows
cabeçalho	dsparse.h (inclua Ntdsapi.h)
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

DS_MANGLE_FOR

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

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue

Compartilhar via