estrutura WSANAMESPACE_INFOW (winsock2.h)

Artigo
08/27/2023

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

Sintaxe

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

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

Comentários

A estrutura WSANAMESPACE_INFO é usada pelas funções WSAEnumNameSpaceProviders e WSCEnumNameSpaceProviders32 para retornar informações sobre provedores de namespace disponíveis. A estrutura WSANAMESPACE_INFO contém as informações específicas do provedor sobre a entrada de namespace passada para as funções WSCInstallNameSpace e WSCInstallNameSpace32 quando o provedor de namespace foi instalado.

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

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

No Windows Vista e posteriores, WSANAMESPACE_INFOEX, uma versão aprimorada da estrutura WSANAMESPACE_INFO, é retornada por chamadas para as funções WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32

Observação

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