Estrutura DSDISPLAYSPECOPTIONS (dsclient.h)

  • Artigo

A estrutura DSDISPLAYSPECOPTIONS é retornada pelo formato da área de transferência CFSTR_DS_DISPLAY_SPEC_OPTIONS e é usada para fornecer dados a um menu de contexto ou extensão de página de propriedades sobre os especificadores de exibição usados. É importante especificar as credenciais exigidas pela extensão para acessar dados no servidor do Active Directory.

Sintaxe

typedef struct _DSDISPLAYSPECOPTIONS {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD offsetAttribPrefix;
  DWORD offsetUserName;
  DWORD offsetPassword;
  DWORD offsetServer;
  DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;

Membros

dwSize

O tamanho da estrutura para fins de controle de versão.

dwFlags

Um conjunto de sinalizadores que indicam dados sobre o objeto e definem o conteúdo da estrutura. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

DSDSOF_HASUSERANDSERVERINFO (0x00000001)

Os membros offsetUserName, offsetPassword, offsetServer e offsetServerConfigPath são válidos.

DSDSOF_SIMPLEAUTHENTICATE (0x00000002)

Não especifique ADS_SECURE_AUTHENTICATION sinalizador ao chamar ADsOpenObject.

DSDSOF_DONTSIGNSEAL (0x00000004)

Não assinar e selar ao abrir objetos de serviço de diretório.

DSDSOF_DSAVAILABLE (0x40000000)

Força o cliente a evitar verificar se o usuário está autenticado, a rede está presente ou conectada, supondo que o cliente pertença a um domínio controlado por Active Directory Domain Services.

offsetAttribPrefix

Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o prefixo do especificador de exibição do qual a extensão criada foi obtida. Essa cadeia de caracteres pode ser um dos valores a seguir.

"administrador"

A extensão foi obtida do atributo adminPropertyPages .

"shell"

A extensão foi obtida do atributo shellPropertyPages .

O exemplo a seguir mostra como usar esse membro.

pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos + 
    pdso->offsetAttribPrefix);

offsetUserName

Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o nome do usuário usado para autenticar a associação. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, o nome de usuário não será incluído.

O exemplo a seguir mostra como usar esse membro.

pwszUserName = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetUserName);

offsetPassword

Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém a senha usada para autenticar a associação. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, a senha não será incluída.

O exemplo a seguir mostra como usar esse membro.

pwszPassword = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetPassword);

offsetServer

Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o nome do servidor. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, o nome do servidor não será incluído.

O exemplo a seguir mostra como usar esse membro.

pwszServer = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetServer);

offsetServerConfigPath

Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o ADsPath do servidor. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, o caminho do servidor não será incluído.

O exemplo a seguir mostra como usar esse membro.

pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetServerConfigPath);

Requisitos

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

Confira também

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Exibir estruturas no Active Directory Domain Services