次の方法で共有

IDebugFAEntryTags::GetProperties メソッド (extsfns.h)

  • [アーティクル]

GetProperties メソッドは、DebugFailureAnalysisTags オブジェクトのタグの名前または説明 (または両方) を取得します。

構文

HRESULT GetProperties(
            FA_TAG Tag,
  [out]     PSTR   Name,
  [in, out] PULONG NameSize,
  [out]     PSTR   Description,
  [in, out] PULONG DescSize,
  [out]     PULONG Flags
);

パラメーター

Tag

FA_TAG列挙の値。 このメソッドは、このタグの名前または説明 (またはその両方) を取得します。

[out] Name

タグの名前である null で終わる文字列を受け取るバッファーへのポインター。 NameSize がタグの名前の長さより小さい場合、このメソッドは NULL ターミネータを含む NameSize バイトのみをこのバッファーにコピーします。

[in, out] NameSize

入力時に、このパラメーターは Name が指すバッファーのサイズをバイト単位で指定 します。 出力時に、このパラメーターはタグの名前のサイズ (バイト単位) を受け取ります。 タグに名前がない場合、このパラメーターは 0 の値を受け取ります。

メモName が NULL の場合、このパラメーターは情報を受け取らなくなります。 Name と NameSize の両方を NULL 以外の値に設定するか、両方を NULL に設定する必要があります。
 

[out] Description

タグの説明である null で終わる文字列を受け取るバッファーへのポインター。 DescSize がタグの説明の長さより小さい場合、このメソッドは、NULL ターミネータを含む DescSize バイトのみをこのバッファーにコピーします。

[in, out] DescSize

入力時に、このパラメーターは Description が指すバッファーのサイズをバイト単位で指定 します。 出力時に、このパラメーターはタグの説明のサイズ (バイト単位) を受け取ります。 タグに説明がない場合、このパラメーターは 0 の値を受け取ります。

メモDescription が NULL の場合、このパラメーターは情報を受け取らなくなります。 Description と DescSize の両方を NULL 以外の値に設定するか、両方を NULL に設定する必要があります。
 

[out] Flags

予約済み。 このパラメーターを NULL に設定します。

戻り値

このメソッドによって返される HRESULT 値は、winerror.h および strsafe.h で定義されます。 このメソッドによって返される値には、次のものが含まれますが、これらに限定されません。

リターン コード 説明
S_OK
 このメソッドは、要求された名前または説明 (またはその両方) を正常に取得し、要求された文字列または文字列の切り捨ては必要ありません。
STRSAFE_E_INSUFFICIENT_BUFFER
 このメソッドは、要求された名前または説明 (またはその両方) を取得しましたが、名前または説明は切り捨てられました。
STRSAFE_E_INVALID_PARAMETER
呼び出し元が少なくとも 1 つの無効なパラメーターを渡しました。

要件

要件 値
対象プラットフォーム デスクトップ
Header extsfns.h

こちらもご覧ください

IDebugFAEntryTags

IDebugFailureAnalysis2

SetProperties

!analyze を拡張する分析拡張機能プラグインの作成

_EFN_Analyze