drtGetInstanceName 函式 (drt.h)

DrtGetInstanceName 函式會擷取對應至指定DRT句柄之分散式路由表實例的完整名稱。

語法

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

[in] hDrt

DRT 實例的句柄。

[in, out] ulcbInstanceNameSize

pwzDrtInstanceName 緩衝區的長度。

[out] pwzDrtInstanceName

包含與 hDRT 相關聯的DRT實例完整名稱。

此函式會在成功時傳回S_OK。其他可能的值包括：

傳回碼	Description
E_INVALIDARG	pwzDrtInstanceName 為 NULL。
E_HANDLE	hDrt 無效。
DRT_E_INSUFFICIENT_BUFFER	pwzDrtInstanceName 緩衝區的大小不足。