GetServiceA.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

GetServiceA (WSOCK32.1119)

SYNOPSIS

INT GetServiceA
 (
  DWORD                dwNameSpace,
  LPGUID               lpGuid,
  LPSTR                lpServiceName,
  DWORD                dwProperties,
  LPVOID               lpBuffer,
  LPDWORD              lpdwBufferSize,
  LPSERVICE_ASYNC_INFO lpServiceAsyncInfo
 )

DESCRIPTION

Get information about a network service.

PARAMS

dwNameSpace [In] Name space or set of name spaces within which the function.

will operate.

lpGuid [In] Pointer to GUID of network service type.

lpServiceName [In] NUL-terminated ASCII string that uniquely represents the name.

of the service.

dwProperties [In] Flags specifying which information to return in lpBuffer.

lpBuffer [Out] Pointer to buffer where the function returns an array.

of NS_SERVICE_INFO.

lpdwBufferSize [In/Out] Size of lpBuffer. A greater number on output.

indicates an error.

lpServiceAsyncInfo [Out] Reserved. Set to NULL.

RETURNS

Success: 0.

Failure: SOCKET_ERROR. GetLastError(3w) returns ERROR_INSUFFICIENT_BUFFER or ERROR_SERVICE_NOT_FOUND.

NOTES

Obsolete Microsoft-specific extension to Winsock 1.1, Protocol-independent name resolution provides equivalent functionality in Winsock 2.

BUGS

Unimplemented.

IMPLEMENTATION

Defined in "nspapi.h".

Implemented in "dlls/wsock32/service.c".

Debug channel "winsock".