IFsrmSetting::EmailTest-Methode (fsrm.h)

Artikel
02/27/2024

Senden Sie eine E-Mail-Nachricht an die angegebene E-Mail-Adresse.

Syntax

HRESULT EmailTest(
  [in] BSTR mailTo
);

Parameter

[in] mailTo

Die E-Mail-Adresse. Die Zeichenfolge ist auf 255 Zeichen beschränkt.

Rückgabewert

Die -Methode gibt die folgenden Rückgabecodes zurück:

Hinweise

Verwenden Sie diese Methode, um den in der SmtpServer-Eigenschaft angegebenen SMTP-Server zu testen. Der Absender wird in der MailFrom-Eigenschaft angegeben (kann nicht auf "[Admin Email]" festgelegt werden.

Betreff und Nachrichtentext sind vordefinierter, lokalisierter Text.

Beispiele

Im folgenden Beispiel wird der Aufruf dieser Methode veranschaulicht.

#ifndef UNICODE
#define UNICODE
#endif

#include <windows.h>
#include <stdio.h>
#include <comutil.h>
#include <fsrm.h>       // FSRM base objects and collections
#include <fsrmtlb_i.c>  // contains CLSIDs

//
// Call the IFsrmSetting::EmailTest method to test the SMTP email server.
//
void wmain(void)
{
  HRESULT hr = 0;
  IFsrmSetting* pSettings = NULL;

  hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
  if (FAILED(hr))
  {
    wprintf(L"CoInitializeEx() failed, 0x%x.\n", hr);
    exit(1);
  }

  hr = CoCreateInstance(CLSID_FsrmSetting, 
                        NULL,
                        CLSCTX_LOCAL_SERVER,
                        __uuidof(IFsrmSetting),
                        reinterpret_cast<void**> (&pSettings));

  if (FAILED(hr))
  {
    wprintf(L"CoCreateInstance(FsrmSetting) failed, 0x%x.\n", hr);
    if (E_ACCESSDENIED == hr)
      wprintf(L"Access denied. You must run the client with an elevated token.\n");

    goto cleanup;
  }

  wprintf(L"Successfully created Setting object.\n");

  // Specify the SMTP server to use for sending email.
  hr = pSettings->put_SmtpServer(_bstr_t(L"<FQDNOFSMTPSERVER>")); 
  if (FAILED(hr))
  {
    wprintf(L"pSettings->put_SmtpServer failed, 0x%x.\n", hr);
    goto cleanup;
  }

  // Test the specified SMTP server. If the test succeeds, you will find a 
  // predefined email message in C:\Inetpub\mailroot\Drop. You can use 
  // Outlook Express to read the message.

  hr = pSettings->EmailTest(_bstr_t(L"admin@<FQDNOFSMTPSERVER>"));
  if (FAILED(hr))
  {
    wprintf(L"pSettings->EmailTest failed, 0x%x.\n", hr);
    goto cleanup;
  }

  wprintf(L"Successfully sent mail.\n");

cleanup:

  if (pSettings)
    pSettings->Release();

  CoUninitialize();
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	fsrm.h (einschließlich FsrmQuota.h, FsrmReports.h, FsrmScreen.h)
DLL	SrmSvc.dll

Weitere Informationen

FsrmSetting

IFsrmSetting

Freigeben über