DrtGetInstanceName function (drt.h)

The DrtGetInstanceName function retrieves the full name of the Distributed Routing Table instance that corresponds to the specified DRT handle.

Syntax

HRESULT DrtGetInstanceName(
  [in]      HDRT  hDrt,
  [in, out] ULONG ulcbInstanceNameSize,
  [out]     PWSTR pwzDrtInstanceName
);

Parameters

[in] hDrt

Handle to the DRT instance.

[in, out] ulcbInstanceNameSize

The length of the pwzDrtInstanceName buffer.

[out] pwzDrtInstanceName

Contains the complete name of the DRT instance associated with hDRT.

Return value

This function returns S_OK on success. Other possible values include:

Return code Description
E_INVALIDARG
pwzDrtInstanceName is NULL.
E_HANDLE
hDrt is invalid.
DRT_E_INSUFFICIENT_BUFFER
The pwzDrtInstanceName buffer is insufficient in size.

Requirements

Requirement Value
Minimum supported client Windows 7 Professional [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header drt.h
Library Drt.lib
DLL Drt.dll

See also

DrtOpen