IDirectMusicScript8::EnumRoutine

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

IDirectMusicScript8::EnumRoutine

The EnumRoutine method retrieves the name of a routine in a script. This method might be used by authoring applications that need to enumerate all routines in a script.

Syntax

HRESULT EnumRoutine(
  DWORD dwIndex, 
  WCHAR *pwszName
);

Parameters

dwIndex

Zero-based index of the routine.

pwszName

Pointer to a string buffer that receives the name of the routine. Must contain at least MAX_PATH elements.

Return Values

If the method succeeds, one of the following success codes is returned:

Return code Description
S_OK The routine was enumerated.
S_FALSE There is no routine with the supplied index value.
DMUS_S_GARBAGE_COLLECTED See Garbage Collection.
DMUS_S_STRING_TRUNCATED The name is longer than MAX_PATH.

If the method fails, return values can include the following:

Return code
DMUS_E_NOT_INIT
E_POINTER

Requirements

  Header: Declared in dmusici.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.