ISmsMessage::GetAttachmentByName Method

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The ISmsMessage::GetAttachmentByName method, in Configuration Manager, gets a message attachment by name.

[IDL]
HRESULT GetAttachmentByName( 
      LPCWSTR szName, 
      ISmsMessageAttachment** ppAttach
);

Parameters

• szName
  Data type: LPCWSTR

  Qualifiers: [in]

  Null-terminated string specifying the name of the attachment.

• ppAttach
  Data type: ISmsMessageAttachment

  Qualifiers: [out]

  Pointer to an ISmsMessageAttachment Interface object representing the attachment.

Return Value

An HRESULT code. Possible values include, but are not limited to, the following:

• S_OK
  The method succeeded.

Remarks

Your application uses this method to get an attachment if its name is known in advance. It first calls ISmsMessage::GetAttachmentCount Method and ISmsMessage::GetAttachmentByIndex Method to enumerate all attachments.

See Also

Concepts

ISmsMessage Interface
ISmsMessageAttachment Interface