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 の少なくとも 1 つが NULL です。
ERROR_NOT_FOUND	指定したフレンドリ名に対応する GUID 名が見つかりませんでした。