MprConfigGetGuidName 函式 (mprapi.h)

MprConfigGetGuidName 函式會傳回對應至指定易記名稱之介面的 GUID 名稱。

語法

DWORD MprConfigGetGuidName(
  [in]  HANDLE hMprConfig,
  [in]  PWSTR  pszFriendlyName,
  [out] PWCHAR pszBuffer,
  [in]  DWORD  dwBufferSize
);

[in] hMprConfig

路由器組態的句柄。藉由呼叫 MprConfigServerConnect 來取得此句柄。

[in] pszFriendlyName

Unicode 字串的指標，指定介面的易記名稱。

[out] pszBuffer

接收介面 GUID 名稱之緩衝區的指標。

[in] dwBufferSize

指定 pszBuffer 所指向之緩衝區的大小，以位元組為單位。

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
ERROR_BUFFER_OVERFLOW	pszBuffer 所指向的緩衝區不夠大，無法保存傳回的 GUID 名稱。
ERROR_INVALID_PARAMETER	至少有一個參數 hMprConfig、 pszFriendlyName 或 pszBuffer 為 NULL。
ERROR_NOT_FOUND	找不到對應至指定易記名稱的 GUID 名稱。