INDEX | CLUSTER | FEATURES | SHORT | FRAMES | NO FRAMES |
-- Retrieves the name of the network resource associated
-- with a local device.
-- Parameters
-- lpLocalName - Points to a null-terminated string that
-- specifies the name of the local device
-- to get the network name for.
-- lpRemoteName - Points to a buffer that receives
-- the null-terminated remote name used to make
-- the connection.
-- lpnLength - Points to a variable that specifies the size,
-- in characters, of the buffer pointed to by
-- the lpRemoteName parameter. If the function
-- fails because the buffer is not big enough,
-- this parameter returns the required buffer size.
-- Return Values
-- If the function succeeds, the return value is NO_ERROR.
-- If the function fails, the return value is an error code.
-- To get extended error information, call GetLastError.
-- Retrieves enumeration information for a network resource.
-- You typically use this function when the user specifies an object.
-- Call this function in conjunction with WNetGetResourceParent
-- to determine the placement and nature of the resource in the
-- browse hierarchy. Unlike WNetGetResourceParent,
-- WNetGetResourceInformation always tries to determine the network
-- provider that owns the resource and the type of the resource,
-- although it might not currently be accessible (or even exist
-- if the type of the resource was specified by the caller).
-- Parameters
-- lpNetResource - Specifies the network resource for which
-- the information is required. The lpRemoteName
-- member of the NETRESOURCE structure specifies
-- the remote name of the network resource.
-- The user typically provides this.
-- Determining the values of the lpProvider and
-- especially the dwType members of the NETRESOURCE
-- structure is a time-consuming operation.
-- If the calling application has these values,
-- it should fill them in. Otherwise, it should
-- set them to NULL. All other members in the
-- NETRESOURCE structure are ignored.
-- lpBuffer - Points to the buffer that receives the result.
-- The first field in the buffer is a NETRESOURCE
-- structure. The dwScope, lpRemoteName, lpProvider
-- dwType, and dwUsage members of the structure are
-- returned; all other members are set to NULL.
-- The remote name pointed to by lpRemoteName is
-- in the same syntax as that returned from an
-- enumeration, so that the calling application
-- can perform a case-sensitive string comparison
-- to determine whether the lpRemoteName resource
-- is enumerated.
-- The provider name pointed to by lpProvider is
-- always returned when it is known to which
-- network the resource belongs. If the resource
-- cannot be found on any of the networks, then
-- lpRemoteName is returned as NULL, and lpProvider
-- can be non-NULL if a parent for the resource is
-- known to be on one of the networks.
-- The dwScope member is returned as
-- RESOURCE_CONTEXT if the network resource is
-- part of the user's network context. Otherwise,
-- it is returned as zero.
-- cbBuffer - Specifies the size of the buffer passed to
-- WNetGetResourceInformation. If the buffer is
-- too small to receive even one entry, the
-- function returns the required size of the buffer
-- in this variable, as well the value WN_MORE_DATA.
-- lplpSystem - Points to a string in the buffer pointed to by
-- lpBuffer that specifies the part of the resource
-- that is accessed through system-resource
-- type-specific functions rather than WNet
-- functions.
-- Return Values
-- WN_BAD_NETNAME
-- WN_EXTENDED_ERROR
-- WN_MORE_DATA
-- WN_NO_NETWORK
-- WN_SUCCESS
-- Takes a drive-based path for a network resource and obtains a data
-- structure that contains a more universal form of the name.
-- Parameters
-- lpLocalPath - Points to a null-terminated string that is
-- a drive-based path for a network resource.
-- dwInfoLevel - Specifies the type of data structure that the
-- function will store in the buffer pointed to by
-- lpBuffer. This parameter can be one of
-- the following values (see WAPI_WNET_CONSTANTS):
-- UNIVERSAL_NAME_INFO_LEVEL, REMOTE_NAME_INFO_LEVEL_
-- lpBuffer - Points to a buffer that receives the type of data
-- structure specified by the dwInfoLevel parameter.
-- lpBufferSize - Points to a variable that specifies the size in
-- bytes of the buffer pointed to by lpBuffer.
-- If the function succeeds, it sets the variable
-- pointed to by lpBufferSize to the size in bytes
-- of the data structure stored in the buffer.
-- If the function fails because the buffer is too
-- small, indicated by the ERROR_MORE_DATA error
-- code, it sets the variable pointed to by
-- lpBufferSize to the required buffer size.
-- Return Values
-- If the function succeeds, the return value is NO_ERROR.
-- If the function fails, the return value is an error code.
-- To get extended error information, call GetLastError.
INDEX | CLUSTER | FEATURES | SHORT | FRAMES | NO FRAMES |