Reference

GetServiceA(3w)

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

Declared in "nspapi.h".

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

Debug channel "winsock".

History