estrutura WSANAMESPACE_INFOEXW (winsock2.h)

  • Artigo

A estrutura WSANAMESPACE_INFOEX contém todas as informações de registro de um provedor de namespace.

Sintaxe

typedef struct _WSANAMESPACE_INFOEXW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
  BLOB   ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;

Membros

NSProviderId

Tipo: GUID

Um GUID exclusivo para esse provedor de namespace.

dwNameSpace

Tipo: DWORD

O namespace compatível com esse provedor.

Os valores possíveis para o membro dwNameSpace são listados no arquivo de inclusão Winsock2.h . Vários provedores de namespace são incluídos no Windows Vista e posterior. Outros provedores de namespace podem ser instalados, portanto, os valores possíveis a seguir são apenas aqueles comumente disponíveis. Muitos outros valores são possíveis.

Valor Significado
NS_BTH
 O namespace Bluetooth.

Esse identificador de namespace tem suporte no Windows Vista e posterior.
NS_DNS
 O namespace do DNS (sistema de nomes de domínio).
NS_EMAIL
 O namespace de email.

Esse identificador de namespace tem suporte no Windows Vista e posterior.
NS_NLA
 O namespace NLA (reconhecimento de local de rede).

Esse identificador de namespace tem suporte no Windows XP e posterior.
NS_NTDS
 O namespace do NTDS (serviço de diretório Windows NT).
NS_PNRPNAME
 O espaço de nome ponto a ponto para um nome de par específico.

Esse identificador de namespace tem suporte no Windows Vista e posterior.
NS_PNRPCLOUD
 O espaço de nome ponto a ponto para uma coleção de nomes de pares.

Esse identificador de namespace tem suporte no Windows Vista e posterior.

fActive

Tipo: BOOL

Se TRUE, indica que esse provedor de namespace está ativo. Se FALSE, o provedor de namespace estará inativo e não estará acessível para consultas, mesmo que a consulta faça referência especificamente a esse provedor de namespace.

dwVersion

Tipo: DWORD

O número de versão do provedor de namespace.

lpszIdentifier

Tipo: LPTSTR

Uma cadeia de caracteres de exibição que identifica o provedor de namespace.

ProviderSpecific

Tipo: BLOB

Um blob de dados específico do provedor associado à entrada de namespace.

Comentários

A estrutura WSANAMESPACE_INFOEX é uma versão aprimorada da estrutura WSANAMESPACE_INFO usada pelas funções WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32 para retornar informações sobre provedores de namespace disponíveis. A estrutura WSANAMESPACE_INFOEX contém o blob de dados específico do provedor associado à entrada de namespace passada no parâmetro lpProviderInfo para as funções WSCInstallNameSpaceEx e WSCInstallNameSpaceEx32 .

Atualmente, o único namespace incluído no Windows que usa informações no membro ProviderSpecific da estrutura WSANAMESPACE_INFOEX são provedores de namespace para o namespace NS_EMAIL. O formato do membro ProviderSpecific para um provedor de namespace NS_EMAIL é uma estrutura NAPI_PROVIDER_INSTALLATION_BLOB .

Quando UNICODE ou _UNICODE é definido, WSANAMESPACE_INFOEX é definido como WSANAMESPACE_INFOEXW, a versão Unicode dessa estrutura e o membro da cadeia de caracteres lpszIdentifier são definidos para o tipo de dados LPWSTR .

Quando UNICODE ou _UNICODE não está definido, WSANAMESPACE_INFOEX é definido como WSANAMESPACE_INFOEXA, a versão ANSI dessa estrutura e o membro da cadeia de caracteres lpszIdentifier são definidos para o tipo de dados LPSTR .

A função WSCEnumNameSpaceProvidersEx32 é uma função somente Unicode e retorna WSANAMESPACE_INFOEXW estruturas.

Observação

O cabeçalho winsock2.h define WSANAMESPACE_INFOEX 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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho winsock2.h

Confira também

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32