estrutura WSANAMESPACE_INFOW (winsock2.h)

Artigo
11/20/2024

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

Observações

A estrutura WSANAMESPACE_INFO é usada pelo WSAEnumNameSpaceProviders e funções de 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 o WSCInstallNameSpace e WSCInstallNameSpace32 funções 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 de cadeia de caracteres lpszIdentifier é definido como 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 é definido como o tipo de dados LPSTR .

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

Nota

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

Consulte também

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFOEX

WSCEnumNameSpaceProviders32

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpace

WSCInstallNameSpace32

Compartilhar via