Share via

IATSC_VCT::GetRecordName Method

  • Article

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The GetRecordName method returns the name of a specified channel in the VCT.

Syntax

HRESULT GetRecordName(
  [in]   DWORD dwRecordIndex,
  [out]  WCHAR **pwsName
);

Parameters

  • dwRecordIndex [in]
    Specifies the record number, indexed from zero. Call the IATSC_VCT::GetCountOfRecords method to get the number of records in the VCT.

  • pwsName [out]
    Receives a pointer to a wide-character string. The method allocates the buffer for the string. The caller must release the buffer by calling the CoTaskMemFree function.

Return Value

The method returns an HRESULT. Possible values include those in the following table.

Return code Description

E_OUTOFMEMORY

Insufficient memory.

E_POINTER

NULL pointer argument.

MPEG2_E_OUT_OF_BOUNDS

Index out of bounds.

S_OK

The method succeeded.

Remarks

This method returns the short_name field.

Requirements

Header Declared in Atscpsipparser.h.

See Also

IATSC_VCT Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008