WSAUnadvertiseProvider Function

The WSAUnadvertiseProvider function makes a specific namespace version-2 provider no longer available for clients.

Syntax

INT WSPAPI WSAUnadvertiseProvider(
  __in  const GUID *puuidProviderId
);

Parameter

  • puuidProviderId [in]
    A pointer to the provider ID of the namespace provider.

Rückgabewert

If no error occurs, WSAUnadvertiseProvider returns zero. Otherwise, it returns SOCKET_ERROR, and a specific error code is available by calling WSAGetLastError.

Error code Meaning
WSAEINVAL

A parameter was not valid. This error is returned if the puuidProviderId parameter was NULL.

 

Hinweise

The WSAUnadvertiseProvider function is used as part of the namespace service provider version-2 (NSPv2) architecture available on Windows Vista and later.

On Windows Vista and Windows Server 2008, the WSAUnadvertiseProvider function can only be used for operations on NS_EMAIL namespace providers.

In general, NSPv2 providers are implemented in processes other than the calling applications. NSPv2 providers are not activated as result of client activity. Each provider hosting application decides when to make a specific provider available or unavailable by calling the WSAAdvertiseProvider and WSAUnadvertiseProvider functions. The client activity only results in attempts to contact the provider, when available (when the namespace provider is advertised).

Anforderungen

Mindestens unterstützter Client

Windows Vista

Mindestens unterstützter Server

Windows Server 2008

Header

Ws2spi.h

Bibliothek

Ws2_32.lib

DLL

Ws2_32.dll

Siehe auch

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSASetService