
Envo de SMS mediante Api DLL Dinmica
=======================================

descomsms.dll, le permite enviar SMS a travs de la Plataforma SMS Descom Mensajes.



Licencia
==========
El uso de este cdigo es completamente gratuito. 

Para enviar Mensajes SMS neceitar disponer de una cuenta en Descom SMS con crditos.

Formulario de alta: http://www.descomsms.com/servlet/admin.AdminTelapp?action=DMWstartRegistration
Consultar Precios de crditos: http://www.descomsms.com/tarifas_lssi1.html



Instalacin Rpida de la Clase
===================================
Simplemente copie la librera, descomsms.dll, en la carpeta "%SystemRoot%\system32"



Implementacin
==========================
Est DLL dispone de las siguientes funciones:

	ObtenerSaldo; para poder obtener el saldo de crditos de una cuenta:
		Argumentos:
			LPCSTR idUsuario; Codigo de usuario en la plataforma Descom SMS.
			LPCSTR Usuario; Nombre de Usuario de la cuenta.
			LPCSTR Password; Contrasea de la cuenta
		Retorno:
			valor tipo Int; Nos devuelve el nmero de crditos de la cuenta, salvo que sea un
					valor negativo, en cuyo caso consulte la lista de errores.


	EnviarSMS; para enviar un SMS:
		Argumentos:
			LPCSTR idUsuario; Codigo de usuario en la plataforma Descom SMS.
			LPCSTR Usuario; Nombre de Usuario de la cuenta.
			LPCSTR Password; Contrasea de la cuenta
			LPCSTR Remitente; Remitente del mensaje
			LPCSTR Movil; mvil del destinatario.
			LPCSTR Mensaje; texto del SMS.
		Retorno:
			valor tipo Int; Nos devuelve el cdigo de envo del SMS, salvo que sea un
					valor negativo, en cuyo caso consulte la lista de errores.


	EnviarSMSMasivo; para enviar varios SMS's:
		Argumentos:
			LPCSTR idUsuario; Codigo de usuario en la plataforma Descom SMS.
			LPCSTR Usuario; Nombre de Usuario de la cuenta.
			LPCSTR Password; Contrasea de la cuenta
			LPCSTR Remitente; Remitente del mensaje
			char *Moviles; Array de mviles a los que se le envia el SMS
			int sizeMoviles; Nmero de moviles en el array.
			LPCSTR Mensaje; texto del SMS.
		Retorno:
			valor tipo Int; Nos devuelve el cdigo de envo masivo del SMS, salvo que sea un
					valor negativo, en cuyo caso consulte la lista de errores.


	ObtenerInformeSMS; para obtener el informe de entrega de un SMS:
		Argumentos:
			LPCSTR idUsuario; Codigo de usuario en la plataforma Descom SMS.
			LPCSTR Usuario; Nombre de Usuario de la cuenta.
			LPCSTR Password; Contrasea de la cuenta
			LPCSTR IdDM; Id de envo obetnido desde la funcin EnviarSMS.
		Retorno:
			valor tipo Int; Nos devuelve el estado de entrega del SMS, salvo que sea un
					valor negativo, en cuyo caso consulte la lista de errores.


	ObtenerInformeEnvio; para obtener el informe de entrega de un envio de varios SMS's:
		Argumentos:
			LPCSTR idUsuario; Codigo de usuario en la plataforma Descom SMS.
			LPCSTR Usuario; Nombre de Usuario de la cuenta.
			LPCSTR Password; Contrasea de la cuenta
			LPCSTR Remitente; Remitente del mensaje
			LPCSTR idenviodm; Id de envo obetnido desde la funcin EnviarSMSMasivo.
			int *sin_confirmacion; (variable modificada por la funcin)
					       Obtiene el nmero de SMS sin confirmacin.
			int *confirmados; (variable modificada por la funcin)
					  Obtiene el nmero de SMS confirmadas la entrega.
			int *errores; (variable modificada por la funcin)
				      Obtiene el nmero de SMS con errores:
			int *sin_informacion; (variable modificada por la funcin)
					      Obtiene el nmero de SMS sin informacin.
		Retorno:
			valor tipo Int; Nos devuelve el nmero de mensajes enviados con errores, salvo que sea un
					valor negativo, en cuyo caso consulte la lista de errores.


Lista de Errores
==================

-1; no se obtiene datos de un informe de entrega.
-2; Error de autentificacin en la plataforma.
-3; Error de tratamiento de la respuesta XML.
-4; Resultado erroneo de la respuesta de la Api
-5; Error de conexin a la API.


Ejemplo de usos en VB.Net
===========================
    Private Declare Function ObtenerSaldo Lib _
       "descomsms.dll" ( _
       ByVal idUsuario As String, _
       ByVal Usuario As String, _
       ByVal Password As String _
       ) As Integer

    Private Declare Function EnviarSMS Lib _
       "descomsms.dll" ( _
       ByVal idUsuario As String, _
       ByVal Usuario As String, _
       ByVal Password As String, _
       ByVal Remitente As String, _
       ByVal Movil As String, _
       ByVal Mensaje As String _
       ) As Integer

    Private Declare Function ObtenerInformeSMS Lib _
       "descomsms.dll" ( _
       ByVal idUsuario As String, _
       ByVal Usuario As String, _
       ByVal Password As String, _
       ByVal IdEnvio As String _
       ) As Integer


    Private Declare Function EnviarSMSMasivo Lib _
       "descomsms.dll" ( _
       ByVal idUsuario As String, _
       ByVal Usuario As String, _
       ByVal Password As String, _
       ByVal Remitente As String, _
       ByVal Movil() As String, _
       ByVal NumeroMoviles As Integer, _
       ByVal Mensaje As String _
       ) As Integer

    Private Declare Function ObtenerInformeEnvio Lib _
            "descomsms.dll" ( _
           ByVal idUsuario As String, _
           ByVal Usuario As String, _
           ByVal Password As String, _
           ByVal idenviodm As String, _
           ByRef sin_confirmacion As Integer, _
           ByRef confirmados As Integer, _
           ByRef errores As Integer, _
           ByRef sin_informacion As Integer _
    ) As Integer


Reportar Errores y Soporte
=============================
Mail: soporte@descom.es





Descom, SL
http://www.descomsms.com
http://www.mensajes.tv