estrutura WSANAMESPACE_INFOEXW (winsock2.h)

Artigo
11/20/2024

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 estã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 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 do 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 VERDADEIRO, 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 referencie especificamente 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 do namespace.

Observações

A estrutura WSANAMESPACE_INFOEX é uma versão aprimorada da estrutura de WSANAMESPACE_INFO usada pelo WSAEnumNameSpaceProvidersEx e as funções 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 WSCInstallNameSpaceEx3 2.

Atualmente, o único namespace incluído no Windows que usa informações no ProviderSpecific membro 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 é definido como o tipo de dados LPWSTR.

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

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

Nota

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

Consulte também

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32

Compartilhar via